时间 - time

time

time包提供了时间的显示和测量用的函数。日历的计算采用的是公历。

Time 代表一个纳秒精度的时间点。

程序中应使用 Time 类型值来保存和传递时间，而不是指针。就是说，表示时间的变量和字段，应为 time.Time 类型，而不是 *time.Time. 类型。一个 Time 类型值可以被多个 go 协程同时使用。时间点可以使用 Before、After 和 Equal 方法进行比较。Sub 方法让两个时间点相减，生成一个 Duration 类型值（代表时间段）。Add 方法给一个时间点加上一个时间段，生成一个新的 Time 类型时间点。

Time 零值代表时间点 January 1, year 1, 00:00:00.000000000 UTC。因为本时间点一般不会出现在使用中，IsZero 方法提供了检验时间是否是显式初始化的一个简单途径。

每一个 Time 都具有一个地点信息（即对应地点的时区信息），当计算时间的表示格式时，如 Format、Hour 和 Year 等方法，都会考虑该信息。Local、UTC 和 In 方法返回一个指定时区（但指向同一时间点）的 Time。修改地点 / 时区信息只是会改变其表示；不会修改被表示的时间点，因此也不会影响其计算。

通过 == 比较 Time 时，Location 信息也会参与比较，因此 Time 不应该作为 map 的 key。

获取当前时间

time.Time类型表示时间。我们可以通过time.Now()函数获取当前的时间对象，然后获取时间对象的年月日时分秒等信息。示例代码如下：

package main

import (
	"fmt"
	"time"
)

func main() {
	now := time.Now()
	year := now.Year()     //年
	month := now.Month()   //月
	day := now.Day()       //日
	hour := now.Hour()     //小时
	minute := now.Minute() //分钟
	second := now.Second() //秒
	fmt.Printf("%d-%02d-%02d %02d:%02d:%02d\n", year, month, day, hour, minute, second)
}

//结果：
2021-07-07 14:30:29

获取时间戳

时间戳是自1970年1月1日（08:00:00GMT）至当前时间的总毫秒数。它也被称为Unix时间戳（UnixTimestamp）。

package main

import (
	"fmt"
	"time"
)

func main() {
	now := time.Now()
	timeUnix := now.Unix()     //时间戳
	timeUnixNano := now.UnixNano() //纳秒时间戳
	fmt.Println("timeUnix --> ", timeUnix)
	fmt.Println("timeUnixNano --> ", timeUnixNano)
}

// 结果：
timeUnix -->  1625639542
timeUnixNano -->  1625639542853467500

时间戳转为时间格式

使用time.Unix()函数可以将时间戳转为时间格式。

package main

import (
	"fmt"
	"time"
)

func main() {
	now := time.Now()
	timeUnix := now.Unix()     //时间戳
	t := time.Unix(timeUnix, 0)
	fmt.Println(t)
}


// 结果：
2021-07-07 14:44:41 +0800 CST

时间操作

时间间隔

time.Duration是time包定义的一个类型，它代表两个时间点之间经过的时间，以纳秒为单位。time.Duration表示一段时间间隔，可表示的最长时间段大约290年。

time包中定义的时间间隔类型的常量如下：

const (
    Nanosecond  Duration = 1
    Microsecond          = 1000 * Nanosecond
    Millisecond          = 1000 * Microsecond
    Second               = 1000 * Millisecond
    Minute               = 60 * Second
    Hour                 = 60 * Minute
)

例如：time.Duration表示1纳秒，time.Second表示1秒。

Add - 加或减

我们在日常的编码过程中可能会遇到要求时间+时间间隔的需求，Go语言的时间对象有提供Add方法如下：

func (t Time) Add(d Duration) Time

实例

package main

import (
	"fmt"
	"time"
)

func main() {
	later := time.Now().Add(time.Hour) // 获取当前时间并加上一个小时
	timeUnix := later.Unix()     //时间戳
	t := time.Unix(timeUnix, 0)
	fmt.Println(t)
}

//结果：
2021-07-07 15:58:35 +0800 CST

package main

import (
	"fmt"
	"time"
)

func main() {
	later := time.Now().Add( - time.Hour) // 获取当前时间并减上一个小时
	timeUnix := later.Unix()     //时间戳
	t := time.Unix(timeUnix, 0)
	fmt.Println(t)
}

//结果：
2021-07-07 14:59:15 +0800 CST

Sub - 两个时间相差

求两个时间之间的差值：

func (t Time) Sub(u Time) Duration

实例

返回一个时间段t-u。如果结果超出了Duration可以表示的最大值/最小值，将返回最大值/最小值。要获取时间点t-d（d为Duration），可以使用t.Add(-d)。

实例不一定最优解

package main

import (
	"fmt"
	"time"
)

func main() {
	now := time.Now()
	later := time.Now().Add(time.Hour * 25)

	s := now.Sub(later)
	fmt.Println(s)
	timeUnix := later.Unix()     //时间戳
	t := time.Unix(timeUnix, 0)
	fmt.Println(t)
}


//结果：
-25h0m0s
2021-07-08 16:44:15 +0800 CST

Equal - 两个时间是否相同，考虑时区

func (t Time) Equal(u Time) bool

判断两个时间是否相同，会考虑时区的影响，因此不同时区标准的时间也可以正确比较。本方法和用t==u不同，这种方法还会比较地点和时区信息。

Before - 判断时间是否在指定时间之前

func (t Time) Before(u Time) bool

如果t代表的时间点在u之前，返回真；否则返回假。

After - 判断时间是否在指定时间之后

func (t Time) After(u Time) bool

如果t代表的时间点在u之后，返回真；否则返回假。

时间格式化

时间类型有一个自带的方法Format进行格式化，需要注意的是Go语言中格式化时间模板不是常见的Y-m-d H:M:S而是使用Go的诞生时间2006年1月2号15点04分（记忆口诀为2006 1 2 3 4）。也许这就是技术人员的浪漫吧。

补充：如果想格式化为12小时方式，需指定PM。

package main

import (
	"fmt"
	"time"
)

func main() {
	now := time.Now()
	// 格式化的模板为Go的出生时间2006年1月2号15点04分 Mon Jan
	// 24小时制
	fmt.Println(now.Format("2006-01-02 15:04:05.000 Mon Jan"))
	// 12小时制
	fmt.Println(now.Format("2006-01-02 03:04:05.000 PM Mon Jan"))
	fmt.Println(now.Format("2006/01/02 15:04"))
	fmt.Println(now.Format("15:04 2006/01/02"))
	fmt.Println(now.Format("2006/01/02"))
}


//结果：
2021-07-07 15:50:45.455 Wed Jul
2021-07-07 03:50:45.455 PM Wed Jul
2021/07/07 15:50
15:50 2021/07/07
2021/07/07

解析字符串格式的时间

package main

import (
	"fmt"
	"time"
)

func main() {
	now := time.Now()
	fmt.Println(now)
	// 加载时区
	loc, err := time.LoadLocation("Asia/Shanghai")
	if err != nil {
		fmt.Println(err)
		return
	}
	// 按照指定时区和指定格式解析字符串时间
	timeObj, err := time.ParseInLocation("2006/01/02 15:04:05", "2021/07/07 15:51:20", loc)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(timeObj)
	fmt.Println(timeObj.Sub(now))
}


//结果：
2021-07-07 15:52:39.650337 +0800 CST m=+0.011968801
2021-07-07 15:51:20 +0800 CST
-1m19.650337s